package com.example.demo.service;

import com.example.demo.entity.City;

import java.util.List;

/**
 * 地理位置城市服务层接口
 *
 * @author 叮当猫的百宝箱
 * @since 1.0
 */
public interface CityService {

    /**
     * 根据省份行政编码查询城市信息列表
     *
     * @param provinceCode 省份行政编码
     * @return 城市信息列表
     */
    List<City> getByProvinceCode(String provinceCode);


    /**
     * 根据区/县行政编码获取所属的城市信息
     *
     * @param districtCode 区/县行政编码
     * @return 区/县行政编码所属的城市信息
     */
    City getByDistrictCode(String districtCode);


    /**
     * 根据镇/街道政编码获取所属的城市信息
     *
     * @param townCode 镇/街道政编码
     * @return 镇/街道政编码所属的城市信息
     */
    City getByTownCode(String townCode);
}
